home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / DB_CLIPP / 2614.ZIP / DB-TEST.ZIP / DB-TEST.DOC next >
Text File  |  1988-04-08  |  9KB  |  204 lines

  1.  
  2.  
  3.                                DB-TEST.EXE
  4.                                Version 1.0
  5.  
  6.                              By SCOTT TAYLOR
  7.                           228 Gold Kettle Drive
  8.                           Gaithersburg,MD 20878
  9.  
  10.  
  11.  
  12.  
  13. DB-TEST is a test program to evaluate the time taken to seek
  14. records in a database file. I created this test to determine how
  15. different operating systems handled database performance. I
  16. wanted to be able to compare relative times for different
  17. operating systems, different hardware, and stand alone
  18. workstations that are not on a network. The test results will
  19. display each record as it is being accessed, and it will display
  20. the total elapsed time in seconds required to perform the seeks.
  21. I have found that different operatinng systems running on
  22. identical hardware resulted in different seek times. This can
  23. make a big difference on networks running multiuser database
  24. applications. This test may be used on any PC running DOS 3.0 or
  25. greater. If you will use this program on a standalone PC you must
  26. run the DOS "SHARE.EXE" program in order to provide record
  27. locking support. On some versions of DOS the share program is
  28. called "SHARE.COM". If you use this program on a DOS compatible
  29. network you must also have the "SHARE.EXE" program installed on
  30. the workstations being used. The "SHARE.EXE" program is not
  31. required for Novell networks since the DOS record locking support
  32. is provided by the workstation shell. All stations running in the
  33. test must have full access rights to the same root directory in
  34. order to use the multi-user test mode.
  35.  
  36. When the test is being run the following takes place in the order
  37. shown below:
  38.  
  39.       1)  Seek To The Desired Record
  40.       2)  Lock That Record
  41.       3)  Read The Data In That Record
  42.       4)  Unlock That Record
  43.       5)  Locate The Next Record And Repeat Above Steps
  44.  
  45. This will continue until all desired records have been accessed.
  46. The results will show the total elapsed time (in seconds)
  47. required to seek & read all records.
  48.  
  49.  
  50. When this program is run it checks to see if the test database
  51. file, TESTFILE.DB, and the database configuration file,
  52. DB_QUEUE.CFG, exists in the root directory. If they do not exist
  53. a message will appear indicating that a test database file must
  54. first be generated. Before the test database file is generated
  55. you will need to establish the record size and the number of
  56. records to be used. If no test database has pervoiusly been
  57. established a default configuration size will be displayed. The
  58. default the size for each record is 1024 bytes (1K), and the
  59. default number of records is 1000. This represents a total file
  60. size of 1,024,000 bytes (or 1 megabyte). You must create a test
  61. database using the displayed defaults or choose your own record
  62. information.
  63.  
  64. Using a larger database size will create more work for the
  65. operating system because record seeks will be further apart.
  66.  
  67. Using small record sizes will mean that seeks will occur more
  68. frequently because the records are closer together and a smaller
  69. amount of data will be read with each seek.
  70.  
  71. Using larger record sizes will cause seeks to occur less
  72. frequently. It will be harder on the operating system and hard
  73. disk because more data will be read with each seek and each
  74. record is spread further apart.
  75.  
  76. The number of seeks to be performed during the test period must
  77. be equal to or less than the total number of records in the
  78. database file. If you select a seek style that uses a "SKIP"
  79. pattern, the number of seeks will automatically be adjusted to
  80. the maximum allowable value. For example if the test database
  81. file has 1000 records in it and you select a seek pattern of
  82. "SKIP BY 10", the number of seeks to be performed will be
  83. adjusted to 100. This is because the test will skip over 10
  84. records per seek, therefore 1000 records divided by 10 skips is
  85. 100 seeks.
  86.  
  87. The seek style is the pattern of seeking that you want to be
  88. performed during testing. The different patterns are described
  89. below in the menu options section.
  90.  
  91. For comparing operating systems you should use the same type CPU
  92. and speed, as well as the same hard disk. Then you would only
  93. change operating systems. After running the tests on each you can
  94. compare the relative results.
  95.  
  96.  
  97. STATISTICS:
  98.  
  99.      The statistics window displays the results for the test in
  100.      progress. The following details the results displayed.
  101.  
  102.      CURRENT RECORD:  This displays the actual record number that
  103.      is currently being read.
  104.  
  105.      CURRENT SEEK:  This displays the current seek being
  106.      performed. This value is incremented after each seek until
  107.      the total number of seeks specified have been executed.
  108.  
  109.      ELAPSED SECONDS:  This will display the total number of
  110.      seconds that have elapsed since the test was started. This
  111.      value is updated after every record seek. It is displayed
  112.      with an accuracy of 1/10 seconds.
  113.  
  114.  
  115.  
  116.  
  117. MENU OPTIONS:
  118.  
  119.      The right and left arrow keys are used to highlight the
  120.      different menu options. Pressing the return key allows you
  121.      to enter a value for that option. The <F1> key is used to
  122.      start testing in a single station mode. The <F2> key is used
  123.      to activate the multi-user mode. After all stations  have
  124.      been activated into the multi-user mode you should press the
  125.      <F1> key at the last workstation and each node will begin
  126.      testing simultaneously. The <F3> key is used to generate a
  127.      test database file using the RECORD SIZE & NUMBER OF RECORDS
  128.      shown in the menu. A database file must exist before
  129.      testing. The <ESC> key is used to exit the program to DOS.
  130.      Instructional help text is displayed for each menu option
  131.      that it is selected.
  132.  
  133.  
  134.      RECORD SIZE: This is the size of each record contained in
  135.      the test database. If a test database file already exists
  136.      the current configuration of that file will be displayed.
  137.      If no database file exists than a default of 1024 bytes is
  138.      displayed. The range allowed is from 128 bytes to 8192 bytes
  139.      (8K bytes). A larger record size will increase the
  140.      throughput and will generate a larger test database file
  141.      size. Simply type a value within the allowable range and
  142.      press return to accept.
  143.  
  144.  
  145.      NUMBER OF RECORDS: This is the total number of records that
  146.      exist in the test database. If a test database file exists
  147.      then the current configuration will be displayed. If no test
  148.      file exists then a default of 1000 records will be
  149.      displayed. The range allowed is 1 record to 10000 records.
  150.      More records will generate a larger test database file and
  151.      the larger the test file the better the relative results
  152.      will be. Simply type a value in the allowable range and
  153.      press return to accept.
  154.  
  155.  
  156.      NUMBER OF SEEKS: This is the total number of seeks you wish
  157.      to be performed for the current test period. The number of
  158.      seeks cannot be larger that the total number of records
  159.      allocated in the test database file. The range is from 1 to
  160.      10000 seeks, or the maximum number of records. The maximum
  161.      will be displayed in the help test. Just type in a value
  162.      within the allowable range and press return to accept.
  163.  
  164.  
  165.      SEEK STYLE: This is the seek pattern to be used in testing.
  166.      Use the right arrow key to select a different seek style, or
  167.      pattern, then press return to accept. The different patterns
  168.      are as follows:
  169.           1) OUTER TO INNER
  170.              This would seek records from the outer portions of
  171.              the test database file and work inward. An example
  172.              would be to seek to records 1, 1000, 2, 999, 3, 998,
  173.              4, 997, 5, 996, etc...
  174.  
  175.           2) INNER TO OUTER
  176.              This is the opposite of OUTER TO INNER. It would
  177. seek
  178.              records from the middle of the database file        
  179.              outward. An example would be to seek to records   
  180.              500, 501, 499, 502, 498, 503, 497, 504, etc...
  181.  
  182.           3) SKIP BY 10
  183.              This would start seek at the beginning of the test
  184.              file and skip over 10 records at a time. An example
  185.              would be to seek to records 1, 10, 20, 30, 40, 50,
  186.              60, etc...
  187.  
  188.           4) SKIP BY 100
  189.              This would start seeking at the beginning of the   
  190.              test database file and skip over 100 records at a   
  191.              time. An example would be to seek to records 1, 100,
  192.              200, 300, 400, 500, 600, etc...
  193.  
  194.           5) RANDOM SEEKING
  195.              This would seek to randomly selected records in the
  196.              database test file.
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.